home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / dist / fw_plotutils.idb / usr / freeware / catman / u_man / cat1 / plot.Z / plot
Encoding:
Text File  |  2002-01-08  |  27.7 KB  |  595 lines
  1.  
  2.  
  3.  
  4. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        plot - translate    GNU metafiles to other graphics    formats
  9.  
  10. SSYYNNOOPPSSIISS
  11.        pplloott [ _o_p_t_i_o_n_s ]    [ _f_i_l_e_s    ]
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.        pplloott  translates     files    in  GNU     metafile format to other
  15.        graphics    formats, or displays them on an    X  Window  System
  16.        display.     GNU metafile format is    a device-independent for
  17.        mat for the storage of graphic data.  It     is  the  default
  18.        output  format  of  the    programs  ggrraapphh(1),  ppiicc22pplloott(1),
  19.        tteekk22pplloott(1), and    pplloottffoonntt(1), and is further documented in
  20.        pplloott(5),     since    it  is    an enhanced version of the tradi
  21.        tional pplloott(5) format found on non-GNU  systems.      It  can
  22.        also  be     produced  by the GNU libplot 2-D graphics export
  23.        library (see pplloott(3)).
  24.  
  25.        The output format or display type is specified with the --TT
  26.        option.    The possible output formats and    display    types are
  27.        the same    as  those  supported  by  ggrraapphh(1),  pplloottffoonntt(1),
  28.        ppiicc22pplloott(1),  and  tteekk22pplloott(1).    If an output file is pro
  29.        duced, it is written to standard    output.
  30.  
  31.        Options and file    names may be interspersed on the  command
  32.        line,  but the options are processed before the file names
  33.        are read.  If ----    is seen, it is interpreted as the end  of
  34.        the  options.  If no file names are specified, or the file
  35.        name -- is encountered, the standard input is read.
  36.  
  37. OOPPTTIIOONNSS
  38.    GGeenneerraall OOppttiioonnss
  39.        --TT _t_y_p_e
  40.        ----ddiissppllaayy--ttyyppee _t_y_p_e
  41.           Select _t_y_p_e as the output    format or  display  type.
  42.           It  may  be  "X",    "png", "pnm", "gif", "svg", "ai",
  43.           "ps", "cgm", "fig", "pcl", "hpgl", "regis",  "tek",
  44.           or  "meta" (the default).     These refer respectively
  45.           to the  X     Window     System,  PNG  (Portable  Network
  46.           Graphics)       format,    portable      anymap   format
  47.           (PBM/PGM/PPM), a pseudo-GIF format  that    does  not
  48.           use LZW encoding,    the new    XML-based Scalable Vector
  49.           Graphics format, the format used by Adobe    Illustra
  50.           tor,  Postscript    or  Encapsulated Postscript (EPS)
  51.           that can be edited with iiddrraaww(1),     CGM  format  (by
  52.           default,    confirming  to    the  WebCGM profile), the
  53.           format used by  the  xxffiigg(1)  drawing  editor,  the
  54.           Hewlett-Packard    PCL   5      printer  language,  the
  55.           Hewlett-Packard Graphics Language,  ReGIS     graphics
  56.           format  (which  can  be  displayed by the    ddxxtteerrmm(1)
  57.           terminal emulator    or by a    VT330 or VT340 terminal),
  58.           Tektronix     format     (which     can  be displayed by the
  59.           xxtteerrmm(1) terminal    emulator), and device-independent
  60.           GNU metafile format itself.  Unless _t_y_p_e is "X", an
  61.  
  62.  
  63.  
  64. FSF                 Jun 2000                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  71.  
  72.  
  73.           output file is produced  and  written  to     standard
  74.           output.
  75.  
  76.           Omitting    the --TT option is equivalent to specifying
  77.           --TT  mmeettaa.      Translating  from  metafile  format  to
  78.           itself  is occasionally useful, since there are two
  79.           versions of metafile  format  (see  the  --OO  option
  80.           below).
  81.  
  82.           A     listing  of the fonts available in any    specified
  83.           output format may    be obtained with the ----hheellpp--ffoonnttss
  84.           option   (see  below).   If  a  requested     font  is
  85.           unavailable, a default font  will     be  substituted.
  86.           The  default  font  is  "Helvetica" for "X", "svg",
  87.           "ai", "ps", "cgm", and "fig", "Univers" for  "pcl",
  88.           and "HersheySerif" for "png", "pnm", "gif", "hpgl",
  89.           "regis", "tek", and "meta".
  90.  
  91.        --pp _n
  92.        ----ppaaggee--nnuummbbeerr _n
  93.           Output only page number _n, within    the  metafile  or
  94.           sequence of metafiles that is being translated.
  95.  
  96.           Metafiles     may  consist  of one or more pages, num
  97.           bered beginning with 1.  Also, each page    may  con
  98.           tain  multiple `frames'.    pplloott --TT    XX, pplloott    --TT rreeggiiss,
  99.           and pplloott --TT tteekk, which plot in real time,    will sep
  100.           arate  successive     frames    by screen erasures.  pplloott
  101.           --TT ppnngg, pplloott --TT ppnnmm, pplloott    --TT ggiiff,    pplloott --TT    ssvvgg, pplloott
  102.           --TT  aaii,  pplloott --TT ppss, pplloott    --TT ccggmm,    pplloott --TT    ffiigg, pplloott
  103.           --TT ppccll, and pplloott --TT hhppggll,    which do not plot in real
  104.           time, will output    only the last frame of any multi-
  105.           frame page.
  106.  
  107.           The default behavior, if --pp is not used, is to out
  108.           put  all    pages.     For  example, pplloott --TT XX displays
  109.           each page    in its own X window.  If the --TT     ppnngg,  --TT
  110.           ppnnmm,  --TT    ggiiff, --TT    aaii, or --TT ffiigg option is    used, the
  111.           default  behavior     is  to     output     only  the  first
  112.           nonempty    page, since files in those output formats
  113.           contain only a single page of graphics.
  114.  
  115.           Metafiles    produced by ggrraapphh(1) and pplloottffoonntt(1) con
  116.           tain  only  a single page    (page #1), which consists
  117.           of two frames: an    empty frame to clear the display,
  118.           and a second frame that contains the graphics.
  119.  
  120.        --ss
  121.        ----mmeerrggee--ppaaggeess
  122.           Merge  all  displayed pages into a single    page, and
  123.           also merge all `frames'.
  124.  
  125.           This option is useful when merging together single-
  126.           page plots from different    sources.  For example, it
  127.  
  128.  
  129.  
  130. FSF                 Jun 2000                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  137.  
  138.  
  139.           can be used to merge together plots  obtained  from
  140.           separate invocations of ggrraapphh(1).
  141.  
  142.        ----bbiittmmaapp--ssiizzee _b_i_t_m_a_p___s_i_z_e
  143.           Set  the    size of    the graphics display in    which the
  144.           plot will    be drawn,  in  terms  of  pixels,  to  be
  145.           _b_i_t_m_a_p___s_i_z_e.   The  default  is "570x570".  This is
  146.           relevant only to pplloott --TT XX, pplloott --TT  ppnngg,     pplloott  --TT
  147.           ppnnmm, and pplloott --TT ggiiff, all    of which produce bitmaps.
  148.           If you choose  a    rectangular  (non-square)  window
  149.           size,   the  fonts  in  the  plot     will  be  scaled
  150.           anisotropically, i.e., by    different factors in  the
  151.           horizontal and vertical directions.  For pplloott --TT XX,
  152.           this requires an X11R6 display.  Any font    that can
  153.           not  be  scaled  in  this    way will be replaced by    a
  154.           default scalable font,  such  as    the  vector  font
  155.           "HersheySerif".
  156.  
  157.           The  environment    variable  BBIITTMMAAPPSSIIZZEE  can equally
  158.           well be used to specify the window size.    For back
  159.           ward  compatibility,  the    X resource XXpplloott..ggeeoommeettrryy
  160.           may be used instead.
  161.  
  162.        ----eemmuullaattee--ccoolloorr _o_p_t_i_o_n
  163.           If _o_p_t_i_o_n    is _y_e_s,    replace    each color in the  output
  164.           by  an  appropriate  shade of gray.  This    is seldom
  165.           useful, except when using    pplloott --TT     ppccll  to  prepare
  166.           output  for a PCL    5 device.  (Many monochrome PCL    5
  167.           devices, such as monochrome LaserJets,  do  a  poor
  168.           job  of  emulating  color     on  their own.)  You may
  169.           equally well request color emulation by setting the
  170.           environment variable EEMMUULLAATTEE__CCOOLLOORR to "yes".
  171.  
  172.        ----mmaaxx--lliinnee--lleennggtthh _m_a_x___l_i_n_e___l_e_n_g_t_h
  173.           Set  the    maximum    number of points that a    polygonal
  174.           line may contain,    before it is flushed out,  to  be
  175.           _m_a_x___l_i_n_e___l_e_n_g_t_h.     If  this  flushing  occurs,  the
  176.           polygonal    line will be split into    two or more  sub-
  177.           lines,  though  the splitting should not be notice
  178.           able.  The default value of _m_a_x___l_i_n_e___l_e_n_g_t_h is 500.
  179.  
  180.           The  reason  for    splitting long polygonal lines is
  181.           that some    display     devices  (e.g.,  old  Postscript
  182.           printers    and  pen  HP-GL     plotters)  have  limited
  183.           buffer    sizes.       The      environment     variable
  184.           MMAAXX__LLIINNEE__LLEENNGGTTHH  can  also  be  used to specify the
  185.           maximum line length.
  186.  
  187.        ----ppaaggee--ssiizzee _p_a_g_e_s_i_z_e
  188.           Set the size of the page on which    the plot will  be
  189.           positioned.   This is relevant only to pplloott --TT ssvvgg,
  190.           pplloott --TT aaii, pplloott --TT ppss, pplloott --TT ccggmm, pplloott     --TT  ffiigg,
  191.           pplloott  --TT    ppccll,  and  pplloott     --TT hhppggll.  The default is
  192.           "letter",    which means an 8.5 inch    by 11 inch  page.
  193.  
  194.  
  195.  
  196. FSF                 Jun 2000                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  203.  
  204.  
  205.           Any  ISO page size in the    range "a0"..."a4" or ANSI
  206.           page size    in the range "a"..."e" may  be    specified
  207.           ("letter"     is  an    alias for "a" and "tabloid" is an
  208.           alias for    "b").  "legal" and  "ledger"  are  recog
  209.           nized  page  sizes  also.     The environment variable
  210.           PPAAGGEESSIIZZEE can equally well    be used     to  specify  the
  211.           page size.
  212.  
  213.           The  graphics  display  in  which    the plot is drawn
  214.           will, by default,    be a square region that     occupies
  215.           nearly  the  full     width of the specified    page.  An
  216.           alternative size for the graphics     display  can  be
  217.           specified.   For    example,  the  page size could be
  218.           specified      as   "letter,xsize=4in,ysize=6in",   or
  219.           "a4,xsize=5.0cm,ysize=100mm".  For all of    the above
  220.           except pplloott --TT hhppggll, the graphics    display    will,  by
  221.           default,    be  centered on    the page.  For all of the
  222.           above except pplloott    --TT  ssvvgg     and  pplloott  --TT    ccggmm,  the
  223.           graphics    display     may be    repositioned manually, by
  224.           specifying the location of its lower  left  corner,
  225.           relative to the lower left corner    of the page.  For
  226.           example, the page    size could be specified    as  "let
  227.           ter,xorigin=2in,yorigin=3in",     or    "a4,xori
  228.           gin=0.5cm,yorigin=0.5cm".     It is also  possible  to
  229.           specify  an  offset  vector.  For    example, the page
  230.           size could be specified as "letter,xoffset=1in", or
  231.           "letter,xoffset=1in,yoffset=1.2in",   or    "a4,yoff
  232.           set=-1cm".  In SVG format    and WebCGM format  it  is
  233.           possible    to  specify the    size of    the graphics dis
  234.           play, but    not its    position.
  235.  
  236.        ----rroottaattiioonn _a_n_g_l_e
  237.           Rotate the graphics display by _a_n_g_l_e degrees.  Rec
  238.           ognized  values  are  "0",  "90",    "180", and "270".
  239.           "no" and "yes" are  equivalent  to  "0"  and  "90",
  240.           respectively.   The  environment    variable RROOTTAATTIIOONN
  241.           can also be used to specify a rotation angle.
  242.  
  243.    PPaarraammeetteerr IInniittiiaalliizzaattiioonn OOppttiioonnss
  244.        The following options set the initial  values  of  drawing
  245.        parameters.   However,  all  of these may be overridden by
  246.        directives in a metafile.  In fact, these options are use
  247.        ful  primarily  when  plotting old metafiles in the tradi
  248.        tional (pre-GNU)    pplloott(5)    format,     which    did  not  support
  249.        such directives.
  250.  
  251.        ----bbgg--ccoolloorr _n_a_m_e
  252.           Set  the color initially used for    the background to
  253.           be _n_a_m_e.    This is    relevant only to pplloott --TT XX,  pplloott
  254.           --TT ppnngg, pplloott --TT ppnnmm, pplloott    --TT ggiiff,    pplloott --TT    ssvvgg, pplloott
  255.           --TT ccggmm, and pplloott --TT rreeggiiss.   An  unrecognized  name
  256.           sets  the     color    to the default,    which is "white".
  257.           The environment variable BBGG__CCOOLLOORR    can equally  well
  258.           be used to specify the background    color.
  259.  
  260.  
  261.  
  262. FSF                 Jun 2000                4
  263.  
  264.  
  265.  
  266.  
  267.  
  268. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  269.  
  270.  
  271.           If the --TT    ppnngg or --TT ggiiff option is    used, a    transpar
  272.           ent PNG file or a    transparent  pseudo-GIF,  respec
  273.           tively,  may  be    produced by setting the    TTRRAANNSSPPAARR
  274.           EENNTT__CCOOLLOORR    environment variable to    the name  of  the
  275.           background  color.   If the --TT ssvvgg or --TT ccggmm option
  276.           is used, an output file without a    background may be
  277.           produced by setting the background color to "none".
  278.  
  279.        --ff _s_i_z_e
  280.        ----ffoonntt--ssiizzee _s_i_z_e
  281.           Set the size of the font initially used for render
  282.           ing  text, as a fraction of the width of the graph
  283.           ics display, to be _s_i_z_e.    The default is 0.0525.
  284.  
  285.        --FF _n_a_m_e
  286.        ----ffoonntt--nnaammee _n_a_m_e
  287.           Set the font initially used for text  to    be  _n_a_m_e.
  288.           Font  names are case-insensitive.     If the    specified
  289.           font is not available, the  default  font     will  be
  290.           used.   Which  fonts are available, and the default
  291.           font, depend on which --TT option is  specified  (see
  292.           above).    A list of available fonts can be obtained
  293.           with the ----hheellpp--ffoonnttss option (see    below).
  294.  
  295.        --WW _l_i_n_e___w_i_d_t_h
  296.        ----lliinnee--wwiiddtthh _l_i_n_e___w_i_d_t_h
  297.           Set the initial width of lines, as  a  fraction  of
  298.           the width    of the display,    to be _l_i_n_e___w_i_d_t_h.  A neg
  299.           ative value means    that a default    value  should  be
  300.           used.   This value is format-dependent.  The inter
  301.           pretation    of zero    line width is also  format-depen
  302.           dent  (in    some output formats, a zero-width line is
  303.           the thinnest line    that can be drawn; in  others,    a
  304.           zero-width line is invisible).
  305.  
  306.        ----ppeenn--ccoolloorr _n_a_m_e
  307.           Set  the initial pen color to be _n_a_m_e.  An unrecog
  308.           nized name sets the pen color to the default, which
  309.           is "black".
  310.  
  311.    OOppttiioonnss ffoorr MMeettaaffiillee    OOuuttppuutt
  312.        The  following option is    relevant only if the --TT    option is
  313.        omitted or if --TT    mmeettaa is    used.  In this case the    output of
  314.        pplloott,  like  the     input,     will be in GNU    graphics metafile
  315.        format.
  316.  
  317.        --OO
  318.        ----ppoorrttaabbllee--oouuttppuutt
  319.           Output the portable (human-readable) version of GNU
  320.           metafile    format,     rather     than  the binary version
  321.           (the default).  The format of the    binary version is
  322.           machine-dependent.
  323.  
  324.  
  325.  
  326.  
  327.  
  328. FSF                 Jun 2000                5
  329.  
  330.  
  331.  
  332.  
  333.  
  334. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  335.  
  336.  
  337.    OOppttiioonnss ffoorr BBaacckkwwaarrdd    CCoommppaattiibbiilliittyy
  338.        By  default,  pplloott  assumes  that its input file(s) are in
  339.        either the binary version or the    portable version  of  GNU
  340.        metafile     format.   You    may  specify  that  the    input is,
  341.        instead,     in  the  traditional  Unix  (pre-GNU)     graphics
  342.        metafile    format,    which is documented in pplloott(5).     The tra
  343.        ditional    graphics metafile format was produced by  pre-GNU
  344.        versions    of ggrraapphh(1).
  345.  
  346.        --hh
  347.        ----hhiigghh--bbyyttee--ffiirrsstt--iinnppuutt
  348.           Input  file(s)  are  assumed  to    be in the binary,
  349.           `high byte first'    version    of  traditional     metafile
  350.           format.  This variant is uncommon.
  351.  
  352.        --ll
  353.        ----llooww--bbyyttee--ffiirrsstt--iinnppuutt
  354.           Input file(s) are    assumed    to be in the binary, `low
  355.           byte first' version of traditional metafile format.
  356.           This variant is the most common.
  357.  
  358.        --AA
  359.        ----aasscciiii--iinnppuutt
  360.           Input  file(s)  are  assumed  to    be  in    the ASCII
  361.           (human-readable) variant    of  traditional     metafile
  362.           format.    On  some older Unix systems, this variant
  363.           was produced by pplloottttooaa(1).
  364.  
  365.    IInnffoorrmmaattiioonnaall OOppttiioonnss
  366.        ----hheellpp Print a list of command-line options, and    exit.
  367.  
  368.        ----hheellpp--ffoonnttss
  369.           Print a table of available fonts,     and  exit.   The
  370.           table will depend    on which output    format or display
  371.           type is specified    with the --TT option.  pplloott  --TT  XX,
  372.           pplloott  --TT    ssvvgg, pplloott --TT aaii, pplloott --TT ppss, pplloott --TT ccggmm,
  373.           and pplloott    --TT  ffiigg     each  support    the  35     standard
  374.           Postscript  fonts.   pplloott     --TT ssvvgg, pplloott --TT ppccll, and
  375.           pplloott --TT hhppggll support the 45 standard PCL    5  fonts,
  376.           and   the      latter   two     support   a   number  of
  377.           Hewlett-Packard vector fonts.  All seven support    a
  378.           set  of 22 Hershey vector    fonts, as do pplloott --TT ppnngg,
  379.           pplloott --TT ppnnmm, pplloott    --TT ggiiff,    pplloott --TT    rreeggiiss,    and  pplloott
  380.           --TT tteekk.  pplloott without a --TT option    in principle sup
  381.           ports any    of these fonts,    since its output must  be
  382.           translated to other formats by a further invocation
  383.           of pplloott.
  384.  
  385.           The pplloottffoonntt(1) utility may be  used  to    obtain    a
  386.           character    map of any supported font.
  387.  
  388.        ----lliisstt--ffoonnttss
  389.           Like  ----hheellpp--ffoonnttss, but lists the    fonts in a single
  390.           column to    facilitate piping to other programs.   If
  391.  
  392.  
  393.  
  394. FSF                 Jun 2000                6
  395.  
  396.  
  397.  
  398.  
  399.  
  400. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  401.  
  402.  
  403.           no  output  format is specified with the --TT option,
  404.           the full set of supported    fonts is listed.
  405.  
  406.        ----vveerrssiioonn
  407.           Print the    version    number of pplloott and  the     plotting
  408.           utilities    package, and exit.
  409.  
  410. EENNVVIIRROONNMMEENNTT
  411.        The  environment    variables BBIITTMMAAPPSSIIZZEE,, PPAAGGEESSIIZZEE,,    BBGG__CCOOLLOORR,,
  412.        EEMMUULLAATTEE__CCOOLLOORR,, MMAAXX__LLIINNEE__LLEENNGGTTHH and RROOTTAATTIIOONN serve as back
  413.        ups    for   the      options   ----bbiittmmaapp--ssiizzee,   ----ppaaggee--ssiizzee,
  414.        ----bbgg--ccoolloorr,   ----eemmuullaattee--ccoolloorr,    ----mmaaxx--lliinnee--lleennggtthh,    and
  415.        ----rroottaattiioonn, respectively.  The remaining    environment vari
  416.        ables are specific to individual    output formats.
  417.  
  418.        pplloott --TT XX, which    pops up    a window on an    X  Window  System
  419.        display and draws graphics in it, checks    the DDIISSPPLLAAYY envi
  420.        ronment variable.  Its value determines the  display  that
  421.        will be used.
  422.  
  423.        pplloott  --TT     ppnngg and pplloott --TT ggiiff, which produce output in PNG
  424.        format and pseudo-GIF format respectively, are affected by
  425.        the  IINNTTEERRLLAACCEE  environment  variable.    If  its     value is
  426.        "yes", the output will be interlaced.  Also, if the TTRRAANNSS
  427.        PPAARREENNTT__CCOOLLOORR  environment variable is set to the    name of    a
  428.        color, that color will be treated as  transparent  in  the
  429.        output.
  430.  
  431.        pplloott  --TT     ppnnmm,  which  produces    output in portable anymap
  432.        (PBM/PGM/PPM) format,  is  affected  by    the  PPNNMM__PPOORRTTAABBLLEE
  433.        environment  variable.    If its value is    "yes", the output
  434.        will be in a human-readable format rather than binary (the
  435.        default).
  436.  
  437.        pplloott --TT ccggmm, which produces output in CGM (Computer Graph
  438.        ics Metafile) format, is    affected by  the  CCGGMM__MMAAXX__VVEERRSSIIOONN
  439.        and  CCGGMM__EENNCCOODDIINNGG  environment  variables.  By default, it
  440.        produces    a binary-encoded version of CGM    version    3 format.
  441.        For  backward  compatibility,  the  version  number may be
  442.        reduced by setting CCGGMM__MMAAXX__VVEERRSSIIOONN to "2" or  "1".   Irre
  443.        spective     of  version,  the  output  CGM    file will use the
  444.        human-readable clear text encoding if CCGGMM__EENNCCOODDIINNGG is  set
  445.        to  "clear_text".   However, only binary-encoded    CGM files
  446.        conform to the WebCGM profile.
  447.  
  448.        pplloott  --TT     ppccll,    which    produces   PCL     5   output   for
  449.        Hewlett-Packard    printers and plotters, is affected by the
  450.        environment variable PPCCLL__AASSSSIIGGNN__CCOOLLOORRSS..    It should be  set
  451.        to  "yes"  when producing PCL 5 output for a color printer
  452.        or other    color device.  This will  ensure  accurate  color
  453.        reproduction  by    giving the output device complete freedom
  454.        in assigning colors, internally,    to  its     "logical  pens".
  455.        If it is    "no" then the device will use a    fixed set of col
  456.        ored pens, and will emulate other colors    by shading.   The
  457.  
  458.  
  459.  
  460. FSF                 Jun 2000                7
  461.  
  462.  
  463.  
  464.  
  465.  
  466. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  467.  
  468.  
  469.        default    is  "no"  because monochrome PCL 5 devices, which
  470.        are much    more common than colored ones, must  use  shading
  471.        to emulate color.
  472.  
  473.        pplloott --TT hhppggll, which produces Hewlett-Packard Graphics Lan
  474.        guage output, is    affected  by  several  environment  vari
  475.        ables.    The  most important is HHPPGGLL__VVEERRSSIIOONN,, which may be
  476.        set to "1", "1.5", or "2" (the default).     "1"  means  that
  477.        the  output  should be generic HP-GL, "1.5" means that the
  478.        output should be    suitable for the HP7550A graphics plotter
  479.        and the HP758x, HP7595A and HP7596A drafting plotters (HP-
  480.        GL with some HP-GL/2 extensions), and "2" means    that  the
  481.        output should be    modern HP-GL/2.     If the    version    is "1" or
  482.        "1.5" then the only available fonts will    be vector  fonts,
  483.        and  all     lines will be drawn with a default width (the --WW
  484.        option will not work).  Additionally, if     the  version  is
  485.        "1"  then the filling of    arbitrary curves with solid color
  486.        will not    be supported (circles and rectangles aligned with
  487.        the coordinate axes may be filled, though).
  488.  
  489.        The  position  of the pplloott --TT hhppggll graphics display on the
  490.        page can    be rotated 90 degrees counterclockwise by setting
  491.        the  HHPPGGLL__RROOTTAATTEE     environment  variable to "yes".  This is
  492.        not the same as the rotation obtained with the  ----rroottaattiioonn
  493.        option,    since  it  both     rotates the graphics display and
  494.        repositions its lower left corner toward    another    corner of
  495.        the  page.   Besides "no" and "yes", recognized values for
  496.        HHPPGGLL__RROOTTAATTEE are "0", "90", "180",  and  "270".    "no"  and
  497.        "yes" are equivalent to "0" and "90", respectively.  "180"
  498.        and "270" are supported only if HHPPGGLL__VVEERRSSIIOONN is    "2"  (the
  499.        default).
  500.  
  501.        By  default,  pplloott  --TT  hhppggll will draw with a fixed set of
  502.        pens.  Which pens are present may be specified by  setting
  503.        the  HHPPGGLL__PPEENNSS  environment  variable.  If HHPPGGLL__VVEERRSSIIOONN is
  504.        "1", the    default     value    of  HHPPGGLL__PPEENNSS  is  "1=black";  if
  505.        HHPPGGLL__VVEERRSSIIOONN  is     "1.5"    or  "2",  the  default    value  of
  506.        HHPPGGLL__PPEENNSS     is        "1=black:2=red:3=green:4=yel
  507.        low:5=blue:6=magenta:7=cyan".   The format should be self-
  508.        explanatory.  By    setting    HHPPGGLL__PPEENNSS you may specify a color
  509.        for any pen in the range    #1...#31.  All color names recog
  510.        nized by    the X Window System may    be  used.   Pen     #1  must
  511.        always be present, though it need not be    black.    Any other
  512.        pen in the range    #1...#31 may be    omitted.
  513.  
  514.        If HHPPGGLL__VVEERRSSIIOONN is "2" then pplloott     --TT  hhppggll  will     also  be
  515.        affected     by  the environment variable HHPPGGLL__AASSSSIIGGNN__CCOOLLOORRSS..
  516.        If its value is "yes", then  pplloott  --TT  hhppggll  will  not  be
  517.        restricted  to the palette specified in HHPPGGLL__PPEENNSS:: it will
  518.        assign colors to    "logical pens" in the range #1...#31,  as
  519.        needed.     The  default  value  is  "no" because other than
  520.        color LaserJet printers and DesignJet plotters,    not  many
  521.        HP-GL/2    devices    allow the assignment of    colors to logical
  522.        pens.
  523.  
  524.  
  525.  
  526. FSF                 Jun 2000                8
  527.  
  528.  
  529.  
  530.  
  531.  
  532. PLOT(1)              GNU Plotting Utilities          PLOT(1)
  533.  
  534.  
  535.        Opaque filling and the drawing of visible white lines  are
  536.        supported  only if HHPPGGLL__VVEERRSSIIOONN is "2" and the environment
  537.        variable    HHPPGGLL__OOPPAAQQUUEE__MMOODDEE is "yes" (the default).  If  its
  538.        value  is  "no"    then white lines (if any), which are nor
  539.        mally drawn with    pen #0,    will not be drawn.  This  feature
  540.        is  to  accommodate  older  HP-GL/2  devices.  HP-GL/2 pen
  541.        plotters, for example, do not support opacity or     the  use
  542.        of pen #0 to draw visible white lines.  Some older HP-GL/2
  543.        devices may, in fact, malfunction if asked to draw  opaque
  544.        objects.
  545.  
  546.        pplloott  --TT    tteekk, which produces output for a Tektronix termi
  547.        nal or emulator,    checks the TTEERRMM    environment variable.  If
  548.        the  value  of  TTEERRMM  is     a string beginning with "xterm",
  549.        "nxterm", or "kterm", it    is taken as a sign that     pplloott  is
  550.        running    in  an X Window    System VT100 terminal emulator:    a
  551.        copy of xxtteerrmm(1), nnxxtteerrmm(1), or kktteerrmm(1).  Before  drawing
  552.        graphics,  pplloott    --TT  tteekk    will emit an escape sequence that
  553.        causes the terminal emulator's auxiliary    Tektronix window,
  554.        which  is  normally hidden, to pop up.  After the graphics
  555.        are drawn, an escape sequence that returns control to  the
  556.        original    VT100 window will be emitted.  The Tektronix win
  557.        dow will    remain on the screen.
  558.  
  559.        If the value of TTEERRMM is a string    beginning with    "kermit",
  560.        "ansi.sys",  or    "nansi.sys",  it  is taken as a    sign that
  561.        pplloott is running in the VT100 terminal emulator provided by
  562.        the MS-DOS version of kkeerrmmiitt(1).     Before    drawing    graphics,
  563.        pplloott --TT tteekk will    emit an    escape sequence    that switches the
  564.        terminal     emulator  to  Tektronix mode.    Also, some of the
  565.        Tektronix control codes emitted by pplloott    --TT  tteekk     will  be
  566.        kkeerrmmiitt-specific.      There    will be    a limited amount of color
  567.        support,    which is not normally the case (the 16 `ansi.sys'
  568.        colors  will  be    supported).  After drawing graphics, pplloott
  569.        --TT tteekk will emit    an escape sequence that    returns    the  emu
  570.        lator  to VT100 mode.  The key sequence `ALT minus' can be
  571.        employed    manually within    kkeerrmmiitt to switch between the  two
  572.        modes.
  573.  
  574. SSEEEE AALLSSOO
  575.        ggrraapphh(1),  ppiicc22pplloott(1), tteekk22pplloott(1), pplloottffoonntt(1), pplloott(3),
  576.        pplloott(5),    and "The GNU Plotting Utilities    Manual".
  577.  
  578. AAUUTTHHOORRSS
  579.        pplloott  was  written  by  Robert  S.  Maier   (rrssmm@@mmaatthh..aarrii
  580.        zzoonnaa..eedduu).
  581.  
  582. BBUUGGSS
  583.        Email bug reports to bbuugg--ggnnuu--uuttiillss@@ggnnuu..oorrgg.
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592. FSF                 Jun 2000                9
  593.  
  594.  
  595.